
  TSpinDblEdit  and  TDBSpinDblEdit
  Version 1.5e
   
   (c) copyright 1996-97 W. Braun  All Rights Reserved
 

   Delphi 1-3 / C++Builder VCL-Components
   




Dear developer and user,

with these components you can cover all numerical entryfields
in your application and so you achieve an uniform formatted outward
shape of your application.
 
I hope these components will help you with your work and make it
a little bit easier.



Content

  
   1. Installation
   2. New
   3. Properties
   4. Description
   5. Registration
   6. Glossary	 
   7. Warranty
   8. Shareware

1. Installation 

I. Delphi 1-2 
   Please use for Delphi 1.x  "D_16.ZIP" and for Delphi 2.x  "D_32_2.ZIP".

   1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU
      and Calc.DFM  into any subdirectory; e.g. C:\DELPHI\Z_COMP   
   2. Choose Options | Install Components
   3. Click Add
   4. Type the name of directory where you placed the component followed
      by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU 
   5. Click OK
   6. Click OK

II. Delphi 3
   Please use "D_32_3.ZIP" file 
   1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU
      and Calc.DFM  into any subdirectory; e.g. C:\DELPHI\Z_COMP   
   2. Choose Components | Install Components
   3. Select your favorited package ( default dclusr30.dpk) and 
      click Add.
   4. Type the name of directory where you placed the component followed
      by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU
      or click browse to find the unit DEDSPIN.DCU  
   5. Click Compile
   6. Follow until message 'TSpinDblEdit and TDBSpinDblEdit have been registered'
   7. Save package 

III. C++ Builder
   Please use "D_CB.ZIP" file 
   1. Copy the files DEdSpin.OBJ, DEDPSIN.HPP, DEdSpin.DCR, DEdSpin.RES, Calc.OBJ,
      Calc.HPP and Calc.DFM  into any subdirectory; e.g. C:\CBUILDER\Z_COMP   
   2. Choose Options | Install Components
   3. Click Add
   4. Type the name of directory where you placed the component followed
      by DEDSPIN.OBJ, e.g. C:\CBUILDER\Z_COMP\DEDSPIN.OBJ 
   5. Click OK
   6. Click OK
 

In the new page on your component palette WB you will find 
TSpinDblEdit,TDBSpinDblEdit. 
Now you only have to click these components and 
afterwards you put then on your form at the right position.


2.  New

Version 1.5e ( 08/08/1997)

-Key Alt+Down/Up opens the calculator (like ComboBox)
 suggestion from Thomas Grusche, 100027.231@compuserve.com
-Property ActiveColor 
 suggestion from G.Schmitthenner, Calcul-Schmitthenner@t-online.de 
-Property CalcColor
-Bugfix for Ctl3D = False
-inherited properties like BorderStyle now published into Delphi 2+3 too.


Version 1.5d

 event OnCalClick
 event OnCalOpen
 event OnCalClose
 event OnSpinDownClick
 event OnSpinUpClick



3.  Properties and events 


The following properties and events apply to both components 
TSpinDblEdit, TDBSpinDblEdit


Properties :
ActiveColor     TColor, default clWindow
Alignment       default taRightJustify                                              
AutoCalculator  boolean, pops the calculator OnEnter, default False 
CalcColor       TColor, default clBackGround
CalcDigitsNo    Integer, different DigitsNo for Calculator, 
                result will be rounded.
		Please set after DigitsNo.
Calculator      boolean, Calculatorbutton on/off, default off
CalcHelpContext Integer, HelpContext for Calculator
CalcPosition    Position of Calculatorform, default posAbove
                [posAbove,posBelow,posLeft,posRight,posOnTop]
DigitsNo        Integer,  Digitsnumber  default 2, Min 0 , Max 10
Increment       double, Increment for spin
Info            InfoMessageBox about this component
MaxLength       integer, MaxLength of number (incl. Decimalseparator),
		default 10, Max 30, Min 1 ( DigitsNo = 0 )
		Normally calculated from Max-/MinValue
MaxValue	Double 
MinValue 	Double. If MinValue> = 0 and MaxValue<>MinValue then
		you can't entry negative number
NegColor	TColor, color negative Value
NegFontColor	TColor, fontcolor negative Value
PosFontColor	TColor,  fontcolor positive Value
Spin 		boolean, Spinbuttons on/off, default off
		If Spin is on use the Incrementvalue 
                like TSpinEdit (standard Delphi component )
ThousSeparator 	boolean, Thousandseparator in Value, default True 
Value 		Double

Events 

OnCalClick      Calculator button click
OnCalOpen	Calculator open
OnCalClose      Calculator close
OnSpinDownClick Down button click
OnSpinUpClick   Up button Click 


Additional  the TDBSpinDblEdit have follows properties

DataField	NumericalField , Datatype ftSmallint, ftInteger,
		ftWord, ftFloat, ftCurrency
DataSource	DataSource for Table or Query




Other Properties and Events inherited from TCustomEdit-class.

4. Description

TSpinDblEdit serves for simplification of the entry and/or calculation
of real or integer numbers. The standardly delivered tools from
Borland are only useful for limited possibilities (look TMaskEdit). 
The entry of the numbers in TSpinDblEdit are adequate to a calculator :
the position in front of a comma from the right to the left, 
the position witch follow the comma from the left to the right. 
With the entry of negative-symbol, the actuall number will be 
answered in the negative immediatly.
The different to a calculator consists in the ability to edit 
and in the maximum quantity of the numbers before and after the 
decimal points, which are all given by the programmer.
With a normal entry of numbers the positions before then comma will
be filled up from the left and if the quantity of their maximum
is achieved, it will be changed to the first position behind the comma.
If you press the sign for decimal, the cursor jump automatically to the
first position behind the comma. 

Alignment fixes the justify of the number in the entryfield:
right(standard), centred or left.
DigitsNo is the quantity of the digitnumbers. If no numbers are inserted,
it will be filled up with zero ( e.g. 1.00 if DigitsNo = 2).
Setting will be also update CalcDigitsNo. 

If the property ThousandSeparator are True, the ThousandSeparator-Signs
will be inserted automatically and passed over by the cursor.
NegColor and NegFontColor permit an otherwise-colored performance
of the negative numbers to emphasize them optically.
MinValue, MaxValue and MaxLength are the properties to fix the max.
and min. values. These properties influence each over.
Nonsensical properties will be catched extensively 
( e.g. MinValue > MaxValue, MaxLength < Length(MaxValue)), etc.).

Value is the topical number after the arrangment of the form. 

Spin gives you the possibility for an easy addition or substraction
the topical entry with the number in the Increment-property by click
the upsign(addition) or downsign(substraction). 
You can also use the keys up or down.
Calculator places at your's employer a calculator.
After pressing the symbol for the calculator a calculatorform will
be anvanced, with this the applier can do calculations and afterwards
then applier can overtake the result in the entryfield. 

The calculator is a nonmodalform without a frame.
Calculatorform will be closed by :
-Pressing the enterkey, result will be commit to entryfield
-Klick on '<='-Button, result will be commit to entryfield
-Pressing the escapekey or click outside of calendarform, 
 result will not be commit. 


The additional properties of the TDBSpinDblEdit be useful
for databaseconnection and they can use for display and/or
manipulation the entries of the fields of the connected table or query.
Datafield can be a type of  integer or float fields. 
If the connected table or query is active during the fixing of the
properties of TDBSpinDblEdit in the development environments
( that means : the properties of the connected fields are well-known ),
the properties MaxValue, MinValue and DigitsNo will be automatically
treated as equivalent to them of the connected field and they will
not have to be worked on.  

Other Properties inherited unchanged from TCustomEdit-class.



5. Registration

Registration

Please read also the file order.txt

-Notice : for C++ Builder please register only with Source-Code !!!

Price for this components is 
  -$15.00 (US) without Source 
  -$30.00 (US) with Sourcecode ( > 2000 lines ).

To order you can do this by following options :

1. CompuServe's Online Registration : GO SWREG 

   TSpinDateEdit : -File-ID 14245  without Source
                   -File-ID 14900  with    Source
   TGermDateEdit : -File-ID 15615  without Source
                   -File-ID 15616  with    Source
      Update from TSpinDateEdit : 
                   -File-ID 15617  without Source
      Update from TSpinDateEdit : 
                   -File-ID 15618  with    Source
   TSpinDblEdit :  -File-ID 12832  without Source
                   -File-ID 14901  with    Source   

2. Order by sending me an e-Mail.

3. Fill out and send the order form "order.txt"  

Registered users will receive any updates for the next year. 


The unregistered version can use with all functions, but only while the 
Delphi IDE is running. 


6. Glossary

If you have questions or suggestion, send me some lines by eMail or Fax.
I'm thankfull for every good proposition.



Yours, 

Wilhelm Braun
eMail : 106216.1307@compuserve.com
Fax   : +49 0621 6296754

7. Warranty

THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT 
WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY.

THESE COMPONENTS ARE PROVIDED WITHOUT ANY EXPRESS OR IMPLIED 
WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF 
CONDITIONS AND HARDWARE UNDER WHICH THESE COMPONENTS MAY BE 
USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS 
OFFERED. THE USER IS ADVISED TO TEST THESE COMPONENTS THOROUGHLY 
BEFORE RELYING ON THEM. THE USER MUST ASSUME THE ENTIRE RISK 
OF USING THESE COMPONENTS. 


8. Shareware

THESE COMPONENTS ARE SHAREWARE. 
You may use the shareware version of these components for a 30 day
trial period. If you would like to continue to use these components
after the 30 day trial period, you are required to purchase the licensed
version of these components.


